home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / BBS-Archive / DiskUtil / Misc / BTNTape.lha / doc / tapemon.doc < prev    next >
Text File  |  1994-04-03  |  4KB  |  94 lines
  1. ****    TapeMon:  a monitor program for BTNtape handler           ****
  2. ****       Version 3.0    3/14/94                                 ****
  3. ****       Freeware by Bob Rethemeyer   (drBob@cup.portal.com)    ****
  4. ****      (c) Copyright 1990,1994 Robert Rethemeyer               ****
  5.  
  6. TapeMon is an optional companion program to the BTNtape SCSI
  7. tape handler.  Since the handler cannot directly inform you of what
  8. it is doing,  TapeMon, running in a separate CLI, communicates with
  9. the handler and prints information for you.  Think of it as a window
  10. into the handler.
  11.  
  12. To run TapeMon, bring up a separate CLI window.  Enter "TapeMon" or
  13. "TapeMon [name]", where [name] is the name of the handler device process.
  14. If you do not enter the name, the monitor will default to using "TAPE:".
  15.  
  16. TapeMon may be started either before or after the handler.  If TapeMon
  17. starts first, it will say "Waiting for TAPE: to start".  But if the
  18. handler is already running, it will immediately print handler information.
  19. Note that unless you use "Mount = 1" in your mountlist entry, the handler
  20. does not start running until the first access.
  21.  
  22. Once the handler is loaded and running, you may invoke or terminate
  23. the monitor at any time, but only one TapeMon per handler device.
  24. To terminate the monitor, enter control-C from the TapeMon CLI window,
  25. or send a BREAK command from another CLI.
  26.  
  27. If the handler encounters a tape error, it remembers the data returned
  28. by SENSE.  When TapeMon is started, it prints the retained sense data.
  29. So if you weren't running TapeMon at the time an error occurs, you can
  30. still see the sense data by starting TapeMon after the fact.
  31.  
  32. TapeMon accepts a second command line argument as a flag to print all
  33. the sense information when a sense occurs.  The value of the second
  34. argument is ignored, but if it is present, complete sense is printed.
  35. Example:  TAPEMON TAPE: ALL
  36. The presense of the ALL will cause the sense message to also print
  37. 32 bytes of hex sense information as it is returned from the drive.
  38.  
  39. TapeMon output is to stdout, so you may redirect it if you like.
  40. Example:   TAPEMON >filename
  41.  
  42.  
  43. MESSAGES
  44.  
  45. See the file "message.doc" for messages originating from the handler.
  46. The following summarizes the messages from the monitor:
  47.  
  48.         MESSAGE               MEANS...
  49.   Waiting for ? to mount.   the handler hasn't been mounted yet, or it hasn't
  50.                             started yet (when Mount=0), or you used wrong name.
  51.                             Enter control-C if you don't want to wait.
  52.  
  53.   Port refused connection.  only one copy of TapeMon can talk to a BTN device
  54.    TapeMon already running?   at once. The first one blocks subsequent ones.
  55.  
  56.   Unable to create port.    system problem (should be rare)
  57.  
  58.   ?.device Unit-?  LU-?     shows information derived from mountlist
  59.  
  60.   Drive: ............       shows the manufacturer, model, and ROM version
  61.                             of the drive.  This is the data returned by the
  62.                             drive with the SCSI INQUIRY command.
  63.  
  64.   Sequential Access         One of the first two messages is printed to show
  65.   Direct Access             which type of drive you have.  The third message
  66.   BAD LOGICAL UNIT NUMBER   is printed if you use the wrong L-U number.
  67.  
  68.   Last sense= ?????, yy,zz  retained sense data printed at TapeMon startup.
  69.                             (If you weren't running TapeMon at the time of
  70.                             an error, you can bring it up and see what
  71.                             the cause of the error was from this message.)
  72.  
  73.   ERROR(S) IN STARTUP       printed when the handler detects an unrecognized
  74.                             parameter in the mountlist Startup statement.
  75.  
  76.   TapeMon terminated        monitor has successfully disconnected from handler
  77.                             after control-C.
  78.  
  79.  
  80.  
  81. HOW IT WORKS
  82.  
  83. BTN creates a message port named "BTN_XXXX", where XXXX is the device name.
  84. TapeMon searches for this port and establishes a software connection
  85. to it via messages.  The monitor then waits for messages from the handler.
  86. TapeMon creates a port named "TMON_XXXX".  If TapeMon starts before the
  87. handler, it waits;  BTN will send it a message when it starts up.
  88.  
  89. The handler sends the monitor a message when it needs to print a line.  The
  90. monitor prints the line asynchronously so the handler doesn't need to wait.
  91. A break signal causes the monitor to disconnect itself from the handler
  92. and terminate, while the handler keeps running.
  93.  
  94.